This page documents version 1.2 of the Motif library.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
Modal and modeless dialogs use DialogShell as the Shell
parent. DialogShell widgets cannot be iconified. Instead,
all secondary DialogShell widgets associated with an
ApplicationShell widget are iconified and de-iconified as a
group with the primary widget.
The client indirectly manipulates DialogShell via the
convenience interfaces during creation, and it can directly
manipulate its BulletinBoard-derived child. Much of the
functionality of DialogShell assumes that its child is a
BulletinBoard subclass, although it can potentially stand
alone.
Setting XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt, XXXXmmmmNNNNwwwwiiiiddddtttthhhh, or XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh for either a
DialogShell or its managed child usually sets that resource
to the same value in both the parent and the child. When an
off-the-spot input method exists, the height and width of
the shell may be greater than those of the managed child in
order to accommodate the input method. In this case setting
XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt or XXXXmmmmNNNNwwwwiiiiddddtttthhhh for the shell does not necessarily set
that resource to the same value in the managed child, and
setting XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt or XXXXmmmmNNNNwwwwiiiiddddtttthhhh for the child does not
necessarily set that resource to the same value in the
shell.
For the managed child of a DialogShell, regardless of the
value of the shell's XXXXmmmmNNNNaaaalllllllloooowwwwSSSShhhheeeellllllllRRRReeeessssiiiizzzzeeee, setting XXXXmmmmNNNNxxxx or
XXXXmmmmNNNNyyyy sets the corresponding resource of the parent but does
not change the child's position relative to the parent.
XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss for the child's XXXXmmmmNNNNxxxx or XXXXmmmmNNNNyyyy yields the value of
the corresponding resource in the parent. The _x and _y
coordinates of the child's upper left outside corner
relative to the parent's upper left inside corner are both
zero minus the value of XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh.
Note that the _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l
allows a window manager to change or control the border
width of a reparented top-level window.
CCCCllllaaaasssssssseeeessss
DialogShell inherits behavior and resources from CCCCoooorrrreeee,
WWWWMMMMSSSShhhheeeellllllll((((3333XXXX)))), VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll((((3333XXXX)))), and XXXXmmmmCCCCrrrreeeeaaaatttteeeeDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX)))).